home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 002 / cat10c.arc / CAT.DOC next >
Encoding:
Text File  |  1987-08-05  |  11.0 KB  |  260 lines
  1.  
  2.                 CCCCCCCCCC       AAAAAA       TTTTTTTTTTT
  3.                CCCCCCCCCCC      AAA  AAA      TTTTTTTTTTT 
  4.                CCC             AAA    AAA         TTT
  5.                CCC             AAAAAAAAAA         TTT
  6.                CCC            AAAAAAAAAAAA        TTT
  7.                CCCCCCCCCCC    AAA      AAA        TTT
  8.                 CCCCCCCCCC    AAA      AAA        TTT
  9.  
  10.  
  11.  
  12.                          CATALOG UTILITY 1.0c
  13.  
  14.                  Copyright 1987, EFI Associates, Inc.
  15.                          All Rights Reserved.
  16.  
  17.  
  18.  
  19. What is CAT?
  20.      CAT is a replacement of the DOS DIR command.  CAT functions
  21.      exactly like DIR, but allows you to attach comments to files and
  22.      directories.  To add comments, simply use CAT /E (Edit Mode). 
  23.      When CAT is used to display a directory, the comments will appear
  24.      next to each file.  CAT operates on an IBM PC, XT, AT or
  25.      compatible.
  26.  
  27.  
  28. Quick Start Instructions:
  29.      Change to the root directory (CD \).  Type CAT /E.  Use the Up and
  30.      Down arrows to highlight a file that you wish to comment.  Type in
  31.      the comment.  When finished adding comments, press [F10] to save
  32.      your work.  Press [Esc] to return to DOS.  Type CAT.  At this
  33.      point, you will see the comments that you just created.
  34.  
  35.  
  36. CAT DEMO:
  37.      This version of the CAT utility is a limited working copy.  With
  38.      it, you may only attach comments to files and directories found it
  39.      the root directory.  To add comments, you must be in the root
  40.      directory, or specify the root directory from another directory
  41.      ( CAT \*.* /E ).  Feel free to share this demo version with
  42.      others.
  43.  
  44.  
  45. FULL WORKING COPY AVAILABLE:
  46.      A fully functional copy of CAT may be purchased from EFI
  47.      Associates for $29.95 plus shipping.  The full version will allow
  48.      comments to be attached in every directory.  In the near future,
  49.      CAT will be Ram-Resident with the ability to 'take over' DOS's DIR
  50.      command.  CAT is an on-going project, so there will be periodic
  51.      updates.  EFI welcomes your comments and suggestions and often
  52.      incorporates user suggestions into future releases.  See the end
  53.      of this document for more information on ordering CAT.
  54.  
  55. FILE LOCATIONS:
  56.  
  57.      COMMENT.EFI    Contains all comments for a specified drive.  This
  58.                     file must be in the root directory in order for CAT
  59.                     to recognize it.
  60.  
  61.      CAT.EXE        The Catalog program should be placed in a utility
  62.                     subdirectory, or in a directory that is specified
  63.                     in the PATH command, so that it may be executed
  64.                     from any subdirectory.
  65.  
  66.  
  67. The Full Screen Editor: (CAT /E)
  68.      To add or edit comments, use CAT /E.  You may specify which files
  69.      you wish to edit by using a wildcard specification.  For example,
  70.      if you want to edit only .DOC files, use CAT *.DOC /E.  Once you
  71.      are in the editor, the cursor will be positioned after the first
  72.      filename.  If you wish to enter a comment, simple fill in the
  73.      highlighted area.  The following is a list of supported editing
  74.      keys:
  75.  
  76.  
  77. Editor Functions:
  78.              
  79.      [Home]         Moves cursor to first column.
  80.      [End]          Moves cursor to end of text.
  81.      [Left]         Moves cursor one column to the left.
  82.      [Right]        Moves cursor one column to the right.
  83.      [Tab]          Moves cursor several columns to the right.
  84.      [Shift-Tab]    Moves cursor several columns to the left.
  85.      [Ctl-Left]     Moves cursor one word to the left.
  86.      [Ctl-Right]    Moves cursor one word to the right.
  87.  
  88.      [Up]           Selects previous file.
  89.      [Down]         Selects next file.
  90.      [Enter]        Selects next file, & moves cursor to first column.
  91.      [PgUp]         Scrolls back 1 screen of files.
  92.      [PgDn]         Scrolls forward 1 screen of files.
  93.      [Ctl-PgUp]     Selects very first file.
  94.      [Ctl-PgDn]     Selects very last file.
  95.      [Ctl-Home]     Moves highlighted bar to top of screen.
  96.      [Ctl-End]      Moves highlighted bar to bottom of screen.
  97.  
  98.      [Ins]          Toggles insert mode on and off.
  99.      [Del]          Deletes character at cursor.
  100.      [Backspace]    Deletes previous character.
  101.      [Ctl-Back]     Deletes form cursor to end of line.
  102.      [Ctl-T]        Deletes one word.
  103.      [Ctl-Y]        Deletes entire line.
  104.      [Ctl-U]        Deletes entire line, then selects next file.
  105.  
  106.      [F1]           Help system.  Select number on menu for more help.
  107.      [F2]           Change comment size (either 40 or 65 characters).
  108.      [F3]           Undo changes to current line.
  109.      [F9]           Buffer status display toggle.
  110.      [F10]          Save comments.
  111.      [Esc]          Quit editing and return to DOS.
  112.  
  113.  
  114. ON-LINE HELP:  CAT ?  or [F1] in Editor
  115.      At the DOS prompt, you can enter the help mode by typing CAT ?. 
  116.      Pressing [F1] while in the editor will display the Help Index
  117.      window.  Select a number listed on the window to access help on
  118.      specific areas.  Pressing [Esc] will exit the help system.
  119.  
  120.  
  121. CHANGE COMMENT SIZE:  [F2]
  122.      In the editor, you may use either 40 or 65 character comments.  To
  123.      toggle between these two sizes, press [F2].  If you wish to use
  124.      the 65 character comments, only the file's name and extension will
  125.      appear, allowing for longer comments to be entered.  To have CAT
  126.      display a directory with long comments, use CAT /L.  If you do not
  127.      use /L, long comments will be truncated at 40 characters. 
  128.  
  129.  
  130.  
  131. UNDO:  [F3]
  132.      The editor supports a simple undo command.  After modifying a
  133.      comment, you may restore the comment to it's original state by
  134.      pressing [F3].  Leaving that row will cause CAT to replace the old
  135.      comment with the new one, eliminating the undo feature.
  136.  
  137.  
  138.  
  139. STATUS TOGGLE:  [F9]
  140.      As comments are added to the system, the available buffer space
  141.      decreases.  Displaying the buffer status will allow you to monitor
  142.      the size of your comment file.  When the buffer becomes very full,
  143.      you should use the delete mode (CAT /D) to remove unused files.
  144.  
  145.  
  146.  
  147. SAVE COMMENTS:  [F10]
  148.      As you edit the comments, your work is stored in memory, allowing
  149.      you to cancel your changes if necessary.  When you are satisfied
  150.      with your work, you must save it by pressing [F10], which will
  151.      update the file COMMENT.EFI.
  152.  
  153.  
  154. QUIT:  [Esc]
  155.      To return to DOS, press [Esc].  If you have made changes to the
  156.      comment area, but haven't saved your work, CAT will warn you.  The
  157.      message 'Do you want to save these changes (Y/N) ?' will appear. 
  158.      At this prompt, you can save the work by pressing 'Y', exit to DOS
  159.      by pressing 'N' or return to editing by pressing [Esc].
  160.  
  161. COMMAND LINE PARAMETERS:
  162.  
  163.      /P        Pause mode:  Before the directory listing scrolls off
  164.                the screen, CAT will wait for a keypress to continue.
  165.                (Similar to DIR command)
  166.  
  167.      /W        Wide mode:  Only filenames and extensions will be
  168.                displayed. (Exactly as DIR command)
  169.  
  170.      /E        Edit mode:  Allows full screen editing of comments.  See
  171.                the Full Screen Editor section.
  172.  
  173.      /E/A      Edit mode with Alpha sort: Will sort all files by
  174.                filename.
  175.  
  176.      /D        Delete mode:  Deletes unused comment entries from
  177.                current directory.  See Delete Comments section.
  178.  
  179.      /L        Long mode:  Instructs CAT to display files and comments
  180.                in the long mode.  Only filenames & extensions will be
  181.                displayed, followed by a 65 character comment.
  182.  
  183.      /M=       Match mode:  Will display only those files whose
  184.                comments match a specified string.  See Match String
  185.                section.
  186.  
  187.      ? or /?   Help mode:  CAT will display an index of available help.
  188.  
  189.      /R        Report mode:  Will display a list all subdirectories
  190.                contained in Comment.EFI.  CAT will show each directory
  191.                name along with the number of comments they contain.
  192.  
  193.  
  194.  
  195. DELETE COMMENTS:  CAT /D
  196.      When a file is deleted, it's comment still remains in the comment
  197.      file (COMMENT.EFI).  Sometimes, you may want to keep it's comment,
  198.      in case the file exists again, but other times you may want to
  199.      delete it's comment also.  Using CAT /D will instruct CAT to
  200.      verify that every comment in Comment.EFI belongs to an existing
  201.      file.  Any comment belonging to a deleted file will be removed.
  202.  
  203.  
  204. MATCH STRING:  CAT /M=
  205.      You can instruct CAT to only display files whose comments contain
  206.      a certain string.  The syntax is CAT /M=string.  The string can be
  207.      found anywhere in the comment, and is not case sensitive.  Here
  208.      are some examples:
  209.  
  210.           CAT /M=utility      Display files only if the word 'utility'
  211.                               is found in the comment.
  212.  
  213.           CAT *.EXE /M=dos    Display any EXE file if the comment
  214.                               contains the word 'dos'.
  215.  
  216.           CAT /M or CAT /M=   Display only those files which have
  217.                               comments.
  218.  
  219.  
  220.  
  221. How CAT Works:
  222.      When a comment is added to a directory entry, it is recorded in a
  223.      file called COMMENT.EFI which is located in the root directory on
  224.      the same drive that the file is kept.  Note that the directory
  225.      entry for the file is not changed at all.  When CAT is used to
  226.      display a directory, it scans COMMENT.EFI for a matching file, and
  227.      if found, displays the file's comment.  In the full working
  228.      version, comments in multiple subdirectories are kept in the same
  229.      COMMENT.EFI file for that drive.  CAT is written in 100% 8086
  230.      Assembler language.
  231.  
  232.  
  233. EFI Associates Background:
  234.      EFI Associates was founded in New York in 1985.  Concentrating
  235.      strictly on PC software development, EFI programmers created Flash
  236.      Code, a program generator for dBase III, and Flash-Up Windows, a
  237.      utility which allows programmers to incorporate menus and help
  238.      screens into their applications.  Shortly after, EFI aimed its
  239.      efforts into the PC consulting area.  Quickly, EFI gained a
  240.      reputation as a top-notch consulting firm.  Specializing in unique
  241.      or uncommon application areas, EFI picks up where other consulting
  242.      firms leave off.  Using the PC to its fullest potential, EFI
  243.      developed applications put others to shame.
  244.  
  245.  
  246. Ordering Information:
  247.      To order a full working version of CAT, send $29.95 plus $2.00 for
  248.      shipping and handling to:
  249.  
  250.                     EFI Associates
  251.                     1010 Northern Blvd.
  252.                     Suite 416 - Software Department
  253.                     Great Neck, NY  11021
  254.                     (516) 482-8600
  255.  
  256.      Registered owners of CAT will receive documentation and one free
  257.      update.  Subsequent updates will be available at a reasonable
  258.      price.  Call for information on quantity purchases and site
  259.      licenses.  Dealer inquiries welcome.
  260.